// Copyright 2011 Google Inc. All Rights Reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

/**
 * @fileoverview Utility functions that create restricted Signal objects.  The
 * restricted objects provide only the functionality usable by Chrome Extension
 * scripts.  For example, a script should never be able to call the fire
 * function, it has to use the API which then calls the fire function.
 *
 * @author jasonstredwick@google.com (Jason Stredwick)
 */


goog.provide('mimic.utils');

goog.require('bite.common.signal.Simple');


/**
 * Returns a fake signal.
 * @return {!Object} An object containing the public api for the signal.
 */
mimic.utils.addFakeSignal = function() {
  return {
    'addListener': goog.nullFunction,
    'hasListener': function() { return false; },
    'removeListener': goog.nullFunction
  };
};


/**
 * Takes a signal and returns an interface to the object.
 * @param {!bite.common.signal.Simple} signal The signal instance.
 * @return {!Object} An object containing the public api for the signal.
 */
mimic.utils.addSignal = function(signal) {
  return {
    'addListener': goog.bind(signal.addListener, signal),
    'hasListener': goog.bind(signal.hasListener, signal),
    'removeListener': goog.bind(signal.removeListener, signal)
  };
};

